home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / cli / cpp2.lzh / CPP2.DOC next >
Text File  |  1985-11-20  |  6KB  |  133 lines
  1.  
  2. ------------------------------------------------------------------------------
  3.                    ATARI STtm COMMAND PROCESSOR PROGRAM v1.0a
  4.                                  DOCUMENTATION
  5.                                By:  James M. Eli
  6. ------------------------------------------------------------------------------
  7.  
  8. Caveats of this version:
  9.     1.  No redirection.
  10.     2.  No single drive (2 disk) copies.
  11.  
  12.     The following is a list and brief description of the supported intrinsic
  13. commands.  Specifications enclosed in brackets ( '<' and '>' ) are
  14. optional arguments to the basic commands.  A short example is also given.
  15.  
  16. INTRINSIC COMMANDS:
  17. ------------------------------------------------------------------------------
  18. 1.   CLS
  19.               Clears the screen.
  20. 2.   DIRECTORY <drive> <pathname> <filename.ext>
  21.               Displays file names and file sizes of the specified directory or
  22.               defaults to the current drive / directory.  Wildcards ( '?' and
  23.               '*' ) are allowed.  It then reports remaining bytes free.
  24.               Example: 'DIR  A:*.PRG'
  25. 3.   DELETE <drive> <pathname> filename.ext
  26.      ERASE <drive> <pathname> filename.ext
  27.               Irreversibly deletes the specified file.
  28.               Example: 'DEL  A:COMMAND.PRG'
  29. 4.   RENAME <drive> <pathname> filename.ext <drive> <pathname> filename.ext
  30.               Renames the first specified file to the second specified name.
  31.               Example: 'RENAME  A:CPP.PRG  A:COMMAND.PRG'
  32. 5.   VERSION
  33.               Displays the initial copyright message along with the current
  34.               version number.
  35.               Example: 'VER'
  36. 6.   TYPE <drive> <pathname> filename.ext
  37.               Displays a text file on the screen.  Same as a copy to the
  38.               console.  It is the users responsiblity to determine the type
  39.               of file prior to using this command.  The control-S combination
  40.               of keystrokes pauses output, while control-Q restarts the ouput.
  41.               Example: 'TYPE  B:CPP.DOC'
  42. 7.   COPY <drive> <pathname> filename.ext <drive> <pathname> filename.ext
  43.               Copy from one file to another.  If destination already exists
  44.               source is appended to the destination.  Both filenames must be
  45.               specified.  Does not allow swapping of disks on a single drive
  46.               copy (the buffer is only 4K and would necessitate endless
  47.               switching of disks).  The following destinations are also
  48.               supported: 'CON:' (console), 'PRT:' or 'LPT:' (parallel port),
  49.               'AUX:' or 'SER:' (serial port).
  50.               Example: 'COPY  A:PROGRAM.PRG  B:\GAMES\PROGRAM.PRG'
  51. 8.   CDIR <drive> pathname
  52.               Changes to the specified directory or returns to the top most
  53.               directory if no pathname is specified.
  54.               Example: 'CDIR  A:TEXT'
  55. 9.   MKDIR <drive> pathname
  56.               Creates a new subdirectory with the name specified.
  57.               Example: 'MKDIR  A:TEXT'
  58. 10.  RMDIR <drive> pathname
  59.               Removes an empty existing subdirectory.  If files are present,
  60.               a message indicating this is displayed, and the command is
  61.               aborted.
  62.               Example: 'RMDIR  A:TEXT'
  63.  
  64.  
  65.  
  66.  
  67.  
  68. 11.  EXIT
  69.      QUIT
  70.               Terminates the CP program and returns to the desktop.
  71. 12.  ECHO
  72.               Determines if commands during a batch process are displayed.
  73.               Simply toggles on / off the displaying of commands.
  74.               Example: 'ECHO'
  75. 13.  REM <message>
  76.               A batch command which displays <message> if echo is on.  If echo
  77.               is off then the message is not displayed.  The command is
  78.               useful for placing explanatory notes inside the batch file.
  79.               Example: 'REM  *** ARCHIVE BATCH FILE ***'
  80.  
  81.     If the command entered is not an intrinsic one (see above) we first
  82. assume it to be a switch of the default drive and attempt to change it.  The
  83. prompt will reflect a change in the default (caution: no error checking here,
  84. so you could possibly crash the program by specifying 'Q:', '3:' or some other
  85. silliness).  Next, if it wasn't a change of defaults we attempt to execute it
  86. as a VALID program.  Valid is assumed because again no error checking is done.
  87. The extension '.PRG' is appended automatically to the name (sorry .TOS).  The
  88. command line's tail is passed on (example: 'STWRITER  CPP.DOC').  A simple
  89. batch processor is incorporated also.  Any text file with the '.BAT' extension
  90. and less than 1024 bytes is a legal batch file.  The batch subroutine  will
  91. accept up to 2 parameters (denoted by: '%1' and '%2').  Do not attempt to call
  92. another batch file as it will destroy the calling file (it maybe possible to
  93. call another at the very end of one... although this hasn't been tested).
  94. Here is an example batch file named 'CC.BAT'
  95.  
  96.     REM  *** C BATCH COMPILE ***
  97.     compiler %1.c
  98.     improver %1.o
  99.     linker %1.o -o %1.prg
  100.     delete %1.o
  101.  
  102. This is called with a parameter, i.e. ' CC  CPP '.  Note the extensions are
  103. automatically appended.
  104.     Intrinsic commands can be abbreviated to a reasonable point, but you
  105. must be careful.  As a fallout of this, no program can have a filename the
  106. same as an intrinsic command or batch file.  The control-C key combination
  107. will generally terminate the current command and also return the user back
  108. to the desktop (why and how can I avoid this).  What I attempted to do here
  109. was to simulate an MS-DOS type environment, hence the basic similarity.
  110. The follow-on versions will correct current bugs and (intends) incorporate
  111. some of the caveats.  To wet your appetite, the goal is to have a shell that
  112. is functionally identical to MS-DOS.
  113.     This program is not in the public domain and cannot be sold.  It may be
  114. freely distributed as long as the copyright message remains intact.  Please
  115. distribute it with these instructions so users know of the caveats.  Certainly
  116. any donations for my effort, constructive criticism or suggestions are highly
  117. encouraged and genuinely welcome. I may be reached at:
  118.     James Eli (74176,2137)
  119.     613 Paddy Run Rd.
  120.     Clarksville, TN  37042
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133. əəəəəəəəəəəəəəəəəəəə